ﾒI filled up my disk in 20 minutes! Before Anarchie it would take
me a good hour or more to download the same amount of stuff!ﾓ - Russell Baird
As seen on TV (MacNeil/Lehrer Show, May&October 1994)
As demoed at Appleﾕs World Wide Developers Conference, May 1994
Second Place in the Best Scriptable Application category of the Everyday AppleScriptｪ Contest, June 1994.
4.5 stars - MacUser Sep 1994 (and they were using v1.1.3!)
･ Contents
What Anarchie Does
Features
Using Anarchie
Using Anarchie via AppleScript
Limitations
Small Print
Warranty
Fine Print
How It Works
Version History
Acknowledgements
･ What Anarchie Does
Anarchie is an FTP and Archie client. It will let you browse FTP sites, download files, or find them using an archie server. It requires System 7 and MacTCP 1.1 or later. Unfortunately many Archie servers are a bit on the flaky side, but donﾕt worry, just try another server!
･Features
AppleGuide (thanks to Quinn!).
Drag Manager support.
AppleScritable and Recordable.
SOCKS support.
SITE INDEX support.
Queries Archie servers and lists results.
Gives full access to FTP sites in a connectionless manner.
Save bookmarks to FTP sites for later listing or fetching.
Comes with bookmarks to many popular sites.
Fetches files from list windows with just a double-click.
Supports MacBinary decoding.
Forwards fetched files to StuffIt Expander for decoding.
Fetch&Store files and listings using AppleScript independently of archie.
Uses Fetchﾕs ﾒSuffix Mappingﾓ to determine file type and transfer mode.
Supports UserLandﾕs MenuSharing.
･ Using Anarchie
Note: Anarchie is spelled that way, only the first letter is capitalised, and is pronounced ﾒAnarchyﾓ, not ﾒAn archieﾓ.
Simply launch Anarchie. Choose Preferences and fill in the info there. Then choose Archieﾉ, and select a server, choose the kind of search you want done, the maximum number of matches to return, whether the search is case sensitive, and then type in your search request. Click the Search button. Anarchie will then attempt to query the selected server.
Important: Note that some servers apear to be VERY unstable, certainly the Australian one comes and goes. If you canﾕt get a result from one, just try another. You can fetch an up to date Archie Server List with the ﾒFetch Server Listﾓ menu command. Note also that the larger the number of matches you request, the longer it will take to reply. Usually 20 matches will be plenty.
You can also use Anarchie to simply browse around FTP sites. Choose Getﾉ, then type in the host you want to FTP to (you can also put in a path name after a colon, or you can type (or Paste) in a URL). Then click List and it will fetch a listing of that directory. Then you can double-click folders to fetch further listings. It behaves like TurboGopher in this respect. You can also save references to folders to search them later. Or just use the bookmark files I've provided, for example it lists over a dozen mirrors for the UMich and Info-Mac sites, so if you have trouble connecting to the home sites, try one of the many mirrors.
There are three kinds of archie searches:
simple substring which just looks for the word you type anywhere in the file name.
pattern matching which looks for names like dehqx*.hqx
regular expressions which looks for names like ^dehqx.*¥.hqx$
Each can be either case sensitive or case insensitive. Since the Archie protocol doesnﾕt support all of these options some are converted into strange looking regular expressions.
Anarchie shows you the progress with a wildly inacurate GUESTimate of how long it will take (its not my fault, I just report what the server says). When the server finishes responding, the results will be displayed. You can select some entries and copy them (copies as host:path) or option-copy it (as ftp://host/path, which is the URL (Universal Resource Locator) format). Double-clicking will fetch the file automagically.
If you know the site that the file is at, you can try using the Index command (in the Getﾉ window) to search a site for the file - only a few sites support this command though, so it will often fail to find any files, in which case you should complain to the site administrators and ask them to support the SITE INDEX command.
Anarchie supports using an alex server. Alex is a file caching system that makes an FTP site with directories like /alex/edu/umich/archive/mac/mac/util/comm. When you fetch a file from there, it gets the listing and the fetched file from the original archive, and caches the result on the server so if anyone else gets the file, they get it from the alex server. This is used in Australia to try to cut down on the ftp use of the Australian<->USA link. It isnﾕt very reliable.
Anarchie supports using an FTP firewall. The firewall must pretend to be an FTP server, and must accept usernames of the form <user>@<host>, and then carry out the FTP to <host> specifuying a username of <user>. Anarchie does not support any other kind of firewall, nor does it support any kind of UDP firewall.
Anarchie also supports SOCKS firewalls.
Anarchie will use the Suffix Mappings you define in Fetch to specify the file type and creator via the fileﾕs suffix (eg .txt). If it doesnﾕt recognize the file, it will use binary mode, which means that text files will have carriage returns&linefeeds in them. There is a cute little drag&drop utility called Drop Text by Todd Wilson that will fix such files with a minimum of fuss.
If you have Drag Manager (rumoured to be in System 7.5), then Anarchie will allow you to drag files to or from the Display windows to upload or download files. Warning: some versions of the Drag Manager will crash if you drag more than one file to the Finder (or will simply ignore files other than the first one). Also, if you drag files to the trash can, the Drag Manager will show the zooming rectangles to indicate that the operation failed even though it worked fine.
Tips:
- Set Fetchﾕs Suffix Mapping for .txt, since this is used for View File and other things.
- Make sure you have StuffIt Expander. Setting it to ﾒDelete Originalsﾓ is a good idea.
- If an archie server doesnﾕt answer, try another server.
- If an FTP site is busy, try another. Try less-known servers first to share the load.
- Make bookmarks for your favorite FTP directories (eg info-mac/game!).
- Use ﾒView Selectionﾓ to force files to be downloaded in text mode.
- Most of the Finder Shortcuts work in Anarchieﾕs listing windows.
(eg, command-uparrow opens the parent, typing a name selects it, etc)
- Hold down the option key when you double click/select a menu to edit bookmarks.
- Hold down the option key and choose Edit Retry if the FTP name is slightly wrong.
- Use the Show Log command to refetch files by doubleclicking entries
- The Log will be empty unless you enable logging in the Preferences window.
- Use the Clear menu command to remove entries from the Log.
･ Using Anarchie via AppleScript
You can use Anarchie from AppleScript. It has commands to search an archie server, as well as to fetch a file from an arbitrary ftp site. You must be careful to set the timeout parameter though, otherwise if will fail if you try to fetch a large file.
Example AppleScript:
tell application "Anarchie"
with timeout of 5 * 60 seconds
find "dehqx" server "archie.internic.net" matches 20 with window
store file "HD:file" url "ftp://user:password@host/path"
[Note that the URL can be a proper URL, or a simple ﾒhost:pathﾓ form]
Check out the scripts provide.
Youﾕre on your own when it comes to Frontier, Iﾕve included some stuff from Leonard Rosenthol, but I have no idea what it does - cool and froody things I expect!
･ Limitations
Anarchie requires System 7 and MacTCP 1.1 or later. For large searches, large listings or many listings or searches or whatever, you may need to increase Anarchieﾕs memory partition (use Get Info in the Finder to do this). To display FTP sites, Anarchie assumes the directory listing will look something like a normal Un･x one, if it doesnﾕt, it wonﾕt work. I have a document available on how Anarchie (and other programs) parse the LIST output, so if you are writing a server or client, let me know and Iﾕll send you the document.
There may be problems with MS-Mail and/or Apple's CD-ROM driver v5.0.1. The latter seems to poll the SCSI bus while there is no CD in and these polls somehow lock the machine up if they happen during Anarchie transfers.
You may also have a problem over SLIP/PPP with your modem hanging up during a transfer if your modem init string does not contain &D0 (which tells it not to hang up if the buffer fills up).
･ Small Print
This program is Shareware, which means if you use it, you should send me US$10. US dollars or personal checks in US dollars drawn on US banks are fine.
Site Licensing:
World-Wide Source Code License: US$5000
World-wide license: US$2000
Universities or companies site license: US$500
Curtin University and the University of Western Australia are exempt.
Single-user license: US$10.
Use the Register provided to fill out the registration form and send (Email, Snail-Mail or FAX) it to my US distributer, Kagi Shareware.
If you purchase a site license, contact me for information on how to make this program automatically set the ﾒI Paidﾓ flag in the Preferences dialog (for those who are interested, I leave the ﾒI Paidﾓ checkbox off on my machine to ensure that the About box is not too annoying and it doesnﾕt trouble me, so live with it)
You may distribute this program any way you wish as long as you don't charge for it (reasonable download costs such as Compu$erve are ok I guess (although who would call Compu$erveﾕs download costs reasonable?)). It would probably be a good idea to keep this documentation file with the program, but Iﾕm hardly likely to check up on you now am I! I donﾕt guarantee any support, but I always answer my Email. If I donﾕt answer Email its because your message didnﾕt get to me, or my reply bounced, so try again and include a valid Internet address if you can.
You MAY NOT DISTRIBUTE this program on any disk costing more than $5 without my explicit permission.
･ Warranty
This program should do what Iﾕve described in this document. If it doesnﾕt, you can simply stop using it. If you pay me, and within a year find that it doesnﾕt do what I describe here, then you can notify me and I will refund your money and cancel your license.
･ Fine Print
Peter Lewis hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Peter Lewis will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis or an agent of his has been advised of the possibility of such damages. In no event shall Peter Lewis be liable for any damages, regardless of the form of the claim. The person using the software bears all risk as to the quality and performance of the software.
US Governement:
Government End Users: If you are acquiring the Software and fonts
on behalf of any unit or agency of the United States Government, the
following provisions apply. The Government agrees:
(i) if the Software and fonts are supplied to the Department of
Defense (DoD), the Software and fonts are classified as "Commercial
Computer Software" and the Government is acquiring only "restricted rights"
in the Software, its documentation and fonts as that term is defined in
Clause 252.227-7013(c)(1) of the DFARS; and
(ii) if the Software and fonts are supplied to any unit or agency
of the United States Government other than DoD, the Government's rights in
the Software, its documentation and fonts will be as defined in Clause
52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause
18-52.227-86(d) of the NASA Supplement to the FAR.
･ How It Works
Anarchie connects to the archie server using the UDP prospero protocol and then, thru a complicated dance of exchanged packets, gets a response back which it reassembles into a list and then displays. The fetching is done with the normal FTP protocol.
･ Version History
Still Todo:
Better support for Put (different format uploads)
other FTP commands (arbitrary, mkdir)
Moveable modal Find window
Better GURL AppleEvent support
AppleScript: "save listing", "list by date/size/"
cmd-click the window title to get popup of directories
support passwords in bookmark listing windows
support saving passwords in saved bookmarks
support dragging entried to the bookmark list to create bookmarks
true grey for grey rounded rect around default buttons
Regexp helper?
way cool help window with topics and stuff and throw away the documentation files.
o option double click to close parent window
Option-click headers to sort in reverse (eg au.edu.curtin.info).
"Get Info" like notes for URLs.
Use Expander's Expand event so that I can notify when it's finished.
tcl support?
Remeber last sort, or preference for prefered sort?
fetch a file when it exists should give a helpful prompt.
Try to fetch file.hqx in favour of file.hqx.{Z,z,gz} to see if the site will decode it
AE set/get preferences
AE line 3 of window 1
support for gopher and WWW as well ;-)
1.4.0
Fixed About box popping up all the time bug
Moved firewall stuff out of the generic preferences window into its own window
Added "PASV" preference, and disabled it by default. (So much for following the RFC)
Add FTP menu and Put&Delete menu items.
Active assistance on Put menu command
Weak support for ACCT command.
Support for the geturl command of the URL Suite
1.3.1
Support PORT command if PASV fails
Fixed menus in Preferences window
Dont re-execute commands unnecessarily
Include entire package!!!! Moron!
1.3.0
Anarchie AppleGuide by Quinn!
Support for the SITE INDEX command
SOCKS support
UMich and Info-Mac prefered mirrors.
Bookmarks is now a file
always log, always ﾒauto downloadﾓ
zoom to not showing the path
shift tab in get dialog
1.2.1
Bug fix for downloading binary, non-MacBinary files.
1.2.0d7
~UI changes
~Drag Manager drag only if you click on the file name or icon.
1.2.0d6
~pipeline multiple ftp request (especially important for ftp.apple.com).
~Bookmarks with more than one entry.
~Unbugged nonymous ftp.
~No more negative times hopefully :-)
~support NetWare server
1.2.0d5
~Fixed? progress colours
~Drag Manager support
1.2.0d4
~Save Bookmark should possibly add a string like " Bookmark"
~Only pay attention to option in odoc event if sent from the finder.
~revamp zoom code.
~Edit->Clear on Log window
~Update Balloon help
~Save URL bug
1.2.0d3
~active log (still need to implement clear)
~Totally reorged the command keys (sorry!)
~search menu (Find, Find Again, All at once).
~FTP Transcript
~reasonably complete support for (readonly) nonymous FTP
~support partial and absolute paths
~option-copy in Get dialog copies as URL
~paste of URL splits across fields.
~Fixed up the progress bar (oops ;)
~Added some minor changes to interoperate better with Fetch/NewsWatcher.
1.1.4d1
~Started on transcripts
~Fixed a bug that caused some directories to come up empty, and some -49 errors.
1.1.3
Released three times inside 24 hours to become 1.1.3 - don't ask.
1.1.1d3
~Allow listing host:/path/file*
~uniquefy the destination name rather than prompting.
~Cmd-1,2,3 to set radio buttons in each dialog
~Only numbers in Size and Matches fields.
~Option-(return, doubleclick,etc) all bring up the Edit dialog now.
1.1.1d2
~Improve timeout message (just put up "nothing found" window).
~Time remaining in FTP progress.
~Using new DNR code (lots of new bugs I expect)
~Zoom leaves room for disk icons.
~Fixed a bug that caused ﾒzonesﾓ to be incorrect on occasion.
~Cmd-. or escape while finding terminates the find and displays the results.
1.1.1d1
~Added prefs for opening the Bookmarks List, and not using Expander.
~Fixed bug with dot (.) not working in patterns.
~Open Folder opens a bookmark listing
~cps display in store/fetch progress?
~Partial results - really this time.
~Minor UI fix
~Added URL support to AppleEvents
~Added support for "current selection" AppleEvent
~Fixed bug with binary mode listing transfers (actually a bug in some servers)
1.1.0d7
~Allow port specification in Firewall.
1.1.0d6
~Force save rating et al after changes.
~Fixed some bugs in the cache code (surprise!)
~Fixed some bugs in the sort code (surprise!)
~Improved FTP listing compatibility (the Newton site broke it).
~Minor UI issues and redid balloon help (Thanks Quinn).
~Minor scroll bar glitch. Sigh.
1.1.0d5
~Cache ftp connections to avoid reopening.
~Increase sort speed by an order of magnitude or two.
~Randomize (Sorry Jim :-)
~Fixed colour icons to use only allowed colours, and added bookmark colour icon
~Trashed pref icons, use file type "pref" to get default icon instead.
~balloon help for Window menu
~Dates are not always for THIS year - they are for withing the last year!
~cmd-uparrow opens parent
1.1.0d4
~Balloon Help for menus.
~Regex helper - tutorial.
~Decode .sit/.cpt files after decoding MacBinary file
~mastermind.cpt.hqx (in game/board) is NOT a directory :-(
~Partial results
~added date and mode to the log.
~added retry menu (it might even work)
~position the "save changes" alert.
~status strings
~out of disk space gives sensible error (as do other errors)
~dir name in window listing instead of "Directory Listing"
~New about box? prompt? display usage? Newbie rating
1.1.0d3
~Log file (does it need more info?)
~Barber poll progress
~Pg up/down, home/end keys
~Balloon Help
~increase memory to 300k?
~Save Bookmarks of list window gives no default name
~Out of memory dialog is not big enough
~archie comes up with no server selected???
~cmd keys for fetch list/fetch file? (cmd-1 & cmd-2)
~Edit *menu* doesn't work
~Make button light up on paste
~TEXT mode solution (View Selection)
~Automagic MacBinary detection.
~option-close box & Command-option-W
~close box -> AppleEvent
~Finder shortcuts
1.1.0d2
~Windows menu.
~Full connectionless anonymous FTP client.
~Saveable URL documents
~Non-modal Get File/Directory dialog.
~double-click dir brings up list of files similar to archie list
1.1.0d1
~Finder-like "Name, Size, etc header" with sorting
~Improved "no result" display
~Support FTP firewalls. (do they all behave the same?)
~Preference to open Find window on startup.
~Added the server name to the listing windowﾕs title.
~Supports windows wider than 1000 pixels (well, I don't have one :-)
~Only use "-" in password for anonymous logins, since some servers don't handle it.
1.0.0 - First release
~AE store & list
~GrowZone
~MenuSharing.
~Fixed popup UI to abide by Appleﾕs HIG.
~Alex server support
~Multiple selections in the list window.
~Scriptable&Recordable fetch command
~Fetch SuffixMapping
~Send to StuffIt Expander
~Prefs dialog
･ Acknowledgements
A huge thanks goes to Quinn for the amazing Anarchie Guide. If you like it, please send him a note and say so <quinn@cs.uwa.edu.au>. Also, cc him on any guide-related bugs (please include the guide version number).
Thanks also go to Dmitry Boldyrev & Igor Livshits for the icons, and to various people on my beta list for their suggestions. Quinn & Leonard get the award for most implemented suggestions.
Thanks again to Leonard for the Frontier stuff. Donﾕt ask me what it is, Iﾕm just including it - anything Leonard writes is certainly going to be good :-)
Thanks also to Chris W. Johnson and the folks at University of Texas at Austin for hosting the archie server list fetched by "Fetch Server List". You might like to check out their archive at ftp://ftp.utexas.edu/pub/mac, or at http://wwwhost.ots.utexas.edu/mac/main.html if you want a WWW interface.
Thanks also to Jean-Pierre Kuypers for the french translation.
